 |
|
| If you can't view the Datasheet, Please click here to try to view without PDF Reader . |
|
|
|
| If you can't view the Datasheet, Please click here to try to view without PDF Reader . |
|
|
| Datasheet File OCR Text: |
| DSECASH eCash Evaluation Kit www.maxim-ic.com GENERAL DESCRIPTION The eCash Evaluation Kit demonstrates the speed, (R) reliability, and security of a SHA-1 based iButton eCash system. The provided eCash debit board is a complete stand-alone module that will perform monetary debits in a fast 100ms. The eCash debit board has a serial interface that allows a PC or microprocessor to monitor or provide manual control of the debit process. Utilizing the serial interface, this demo could easily be integrated into a real eCash or access control system. Figure 1. eCash Evaluation Board EVALUATION KIT CONTENTS (3) (2) (4) (1) (1) DS1963S - Coprocessor or user tokens DS1961S - User tokens DS9093A - (2) black, (2) blue DS1402-DR8 - iButton Blue Dota receptor (R) DS9097U-S09 - 1-Wire PC serial port adapter for PC initialization of coprocessor and user tokens (1) DB9 Serial cable - Connects eval board to serial port of a computer to monitor eval board (1) eCash evaluation board (1) Instruction sheet FEATURES * * * * * Stand-alone eCash evaluation circuit board with LCD display and Audible feedback. Supports both DS1963S and DS1961S SHA-1 iButtons as debit tokens. Once initialized, the DS1963S coprocessor on the debit board keeps the money secret secure Secure eCash debits in 100ms (approximate). (R) 2 JavaTM programs (compatible with Windows and Linux) provided for download to initialize eCash coprocessors and tokens as well as to monitor evaluation board. Evaluation board can be used as a component in a larger control system (Service Control Unit). Complete firmware source provided in portable `C' code. Schematic design and list of components of eval board provided. Evaluation board can be used for eCash code development with the onboard single-cycle 8051 compatible DS89C420. ORDERING INFORMATION PART DSECASH DESCRIPTION eCash Evaluation Kit REQUIREMENTS: * The external supply for the eCash evaluation board must be provided. Power supply requirements: AC/DC, 9-20 V, 200mA minimum. See Power Connector below for recommendations. Internet connection required to get initialization and monitoring software. * * * * * iButton and 1-Wire are registered trademarks of Dallas Semiconductor. Blue Dot is a trademark of Dallas Semiconductor. Java is a trademark of Sun Microsystems. Windows is a registered trademark of Microsoft Corp. 1 of 21 10/21/04 DSECASH: eCash Evaluation Kit INTRODUCTION The primary purpose of the eCash Evaluation Kit is to demonstrate SHA-1 iButtons by showing a fully qualified, SHA-1 authenticated, monetary debit in ~100ms using the file and security standards described in other Dallas Semiconductor Application Notes (see White Paper 1 in table below). Applications that this kit targets include: vending, parking meters, toll booths, pay phones, public transportation, gaming, and others requiring either secure payment or user authentication. The following Application Notes dealing with iButton and 1-Wire devices are as follows (it is recommended to start with White Paper 8: "1-Wire SHA-1 Overview"): Table 1. SHA-1 Application Note List White Paper 8: 1-Wire SHA-1 Overview White Paper 4: Glossary of 1-Wire SHA-1 Terms White Paper 3: Why are 1-Wire SHA-1 Devices Secure? White Paper 1: SHA Devices Used in Small Cash Systems App Note 150: Small Message Encryption using SHA Devices App Note 151: Dallas Digital Monetary Certificates App Note 152: SHA iButton Secrets and Challenges App Note 154: Passwords in SHA Authentication App Note 156: DS1963S SHA 1-Wire API Users Guide App Note 157: SHA iButton API Overview The kit incorporates an LCD display, two coprocessors (the DS1963S and DS1961S), external 1-Wire, and a serial port. The board can be operated independently of a PC after initialization of the coprocessors and user tokens. It can also be connected to a PC for configuration, monitoring, and control. The developer can take an already existing embedded system, add some simple serial code to control the eCash board, and quickly be up and running with an iButton-based debiting system, using the eCash evaluation board as a subassembly in a larger system. For this, a serial port and an IDC connector have been made available on the demo board for testing and bench development. Since the firmware's C source is provided with the kit, the developer is also free to extend the capabilities of the system and/or customize it. The kit operating instructions and software are available online: http://www.ibutton.com/ibuttons/ecashkit.html. Two Java programs, eCashInit.java and eCashMonitor.java are included in the software downloads. The eCashInit program initializes iButtons for use as coprocessors and user tokens, and the eCashMonitor program communicates directly with the evaluation board through the included serial cable. BASIC CONFIGURATION To properly setup and configure the eCash evaluation board, the first step is to download and configure the software. Once that is done, then the hardware of the kit can be configured and basic SHA-1 monetary debits shown. Optionally, the evaluation board's firmware can be extended/ehanced/re-written by the developer and loaded onto the board's processor. Software Configuration Prior to first-time use, it is recommended that the software associated with the kit be installed and configured first.. Afterwards, initialization of the SHA-1 iButtons can take place using the software. At least one iButton will need to be setup as a coprocessor and one as a user token. This can be done easily on a PC with the Java Runtime Environment (JRE) pre-installed. If a JRE has not been installed, please visit http://java.sun.com to download and install one. With Java correctly installed, both the eCashInit and eCashMonitor programs can be setup as Java "Web Start" programs. One of the advantages of "Web Start" technology is that every time one of the programs is run, a background process checks for updates to the program and automatically downloads and installs them from our website. The Java "Web Start" page for both of these programs can be found at the following URL: http://www.ibutton.com/ibuttons/ecashjava.html. This page contains complete download, installation, and troubleshooting instructions. 2 of 21 DSECASH: eCash Evaluation Kit Manual Software Installation If for some reason, a manual installation of the eCash software is necessary, instructions are available below. Specifically, see the sections entitled RXTX Instructions, eCashInit Setup Instructions, and eCashMonitor Setup Instructions. RXTX Instructions Both included Java programs, eCashInit and eCashMonitor, require RXTX 2.1 to be installed on the PC. RXTX is a cross-platform serial library used by eCashInit and eCashMonitor to communicate to the DS9097U and to the eCash eval board. The installation of RXTX is performed automatically through the Java "Web Start" process, but, just in case a manual install is necessary, the binaries for the Win32 build are included in the kit download (available from the above URL: http://www.ibutton.com/ibuttons/ecashkit.html). Specifically, RXTX binaries can be found in the software/rxtx folder of the download. If a platform other than 32-bit Windows is used, the binaries and/ or source to RXTX is downloadable from http://www.rxtx.org. eCashInit Setup Instructions Before running the eCashInit program, first install it either through "Web Start" as mentioned above (recommended) or install it by hand. Again, the "Web Start" version can be found at: http://www.ibutton.com/ibuttons/ecashkit.html. To compile and run by hand, follow the instructions below. To compile the eCashInit: javac -classpath " 3 of 21 DSECASH: eCash Evaluation Kit Initializing iButtons as Coprocessors or User Tokens With the DS9097U 1-Wire adapter plugged into the serial port and the DS1402-DR8 Blue Dot plugged into the adapter, run the eCashInit Java program. The following Window appears, asking for which COM port to use with the DS9097U: Figure 2. eCashInit Start Screen Follow the steps presented and select the appropriate COM port. Click OK when finished. 4 of 21 DSECASH: eCash Evaluation Kit The next window to appear gives a choice between two tabs. Selecting the first tab starts the process for creating a SHA-1 coprocessor. Take a DS1963S iButton, snap it into the Blue Dot, and follow the instructions. When finished, snap the coprocessor into one of the iButton clips provided on the evaluation board. Note that the type of user token (DS1961S or DS1963S) needs to be specified. See screen capture below. Figure 3. eCashInit Coprocessor Initialization Screen 5 of 21 DSECASH: eCash Evaluation Kit The second tab of the eCashInit program starts the user token initialization process. Follow the instructions to create the user token. The user token actually carries the monetary value, and needs to be specified during the initialization process. The user token can either be a DS1961S or a DS1963S. Click the "Initialize Now" button to finish creating the user token. See below for screen shot. Figure 4. eCashInit User Token Initialization Screen Hardware Configuration The hardware setup of the eCash evaluation board requires that at least a coprocessor and a user token be created before beginning (see Software Configuration). Once created, plug a coprocessor into the iButton clip of the eCash evaluation board. Next, unplug the DS1402-DR8 Blue Dot from the 1-Wire adapter, and plug it into the RJ11 socket of the eval board. Finally, power up the eCash evaluation board by plugging in the AC adapter. It should look like the picture below. 6 of 21 DSECASH: eCash Evaluation Kit Figure 5. Hardware Setup Please note that the user token iButton is easier to handle when snapped into a key fob. Four key fobs come with the kit. If difficulty is encountered when snapping the iButton into the key fob, then please note that the plastic of the key fob can be loosened with warm water enough so that the iButton snaps in easily. Please make an effort to keep water away from the iButton. The eCash system should now be setup. To debit from the system, just touch the user token iButton to the Blue Dot and watch the debit take place on the LCD screen. Quick Start 1. Plug in DS9097U to the PC. + Blue Dot to PC 2. Select the DS1963S or DS1961S as the user tokens. 3. Initialize a DS1963S as a token type specific coprocessor. 4. Initialize the user tokens selected in step 2 above. 5. Put the coprocessor into an iButton clip on the eCash board. 6. Plug the Blue Dot into the eCash board. 7. Power up eCash board. 8. eCash board as a power-on default will do a fully autonomous debit. 9. Debit user iButtons, view the result on the LCD. EVALUATION KIT USAGE Many experiments can be performed with the evaluation kit. Here are a few suggestions: Experiment 1: See Installation Overview above. Experiment 2: 1. Remove DS9097U from the PC. 2. Plug in the straight through serial cable from the PC to the eCash board. 3. Run eCashMonitor program. 4. Change and view the different operation modes of the eCash board. 5. Debit iButtons using various modes of eCash board, monitor status. Experiment 3: 1. Optionally recycle one of the DS1963S user tokens to make both types of coprocessors. Clip both coprocessors into the eCash board to support both user token types. 2. Debit both the single DS1963S and the DS1961S's with the eCash board, view the results on the LCD. 7 of 21 DSECASH: eCash Evaluation Kit Experiment 4: 1. Optionally connect to some other host/micro using the RS232 port or development connector and implement the eCash serial protocol. Experiment 5: 1. Add the firmware loader jumper and do development on the eCash evaluation board. Experiment 6: 1. Use the firmware source code and design to integrate the eCash functionality into a different board. FIRMWARE The firmware running the evaluation board comes pre-loaded. However, we have made it available in the download package, with source, so that developers can extend or modify the functionality of the evaluation board. The firmware was built using the Keil C51 compiler. Both versions 5.10 and 7.05 of the compiler were tested. The makefile builds all the necessary files and links them. Unfortunately, the Keil linker returns an error status after linking when it issues warnings (just warnings about unused segments). Execute 'make' with the '-i' option to ignore this error and convert the binary to the '.hex' file, ready to load on the DS89C420 eCash board. If the Keil C51 compiler is unavailable to the developer, the pre-built hex file has been included in the download as well. Loader Instructions The firmware loader program is a simple command-line serial loader. It was built and tested on Windows using the Cygwin shell. Cygwin provides a POSIX interface (just like Unix/Linux) for serial I/O, so either Cygwin or another Unix to is needed compile and use this application. Cygwin is available for download from: http://www.cygwin.com/ To build the loader: gcc -o load420 load420.c To run the loader: ./load420 COM1 ../Firmware/ecash.hex After the loader process completes, the board has all the software ready for performing eCash debits. 8 of 21 DSECASH: eCash Evaluation Kit Firmware State Diagram See Figure 6 below for the firmware state diagram. Figure 6. Firmware State Diagram Poll For Token Arrival Authenticate Token And Verify Cert. Auth. Auth. Fail Success NSF Update And Sign New Cert. Updated Yes Timeout Occurred? No Write Fail Write Cert. To Token Written None Gone Wait for Token Departure Present Verify Fail Vend Product Update Status Verified Verify Write To Token HARDWARE SPECIFICATIONS A description of the evaluation board's hardware components are found in the sections below. Covered items are the Development Connector, the RJ11 "Customer" 1-Wire Interface, the DB9 Serial Interface, the Firmware Load Enable Jumper, and the Power Connector. Development Connector IDC (Insulation Displacement Connector) 100 mil spacing. The development connector can be used to remotely monitor and control the eCash evaluation board. Figure 7. IDC Connector 2 4 6 8 10 1 3 5 7 9 9 of 21 DSECASH: eCash Evaluation Kit Table 2. IDC Connector Pin Out PIN 1 2 3 4 5 6 7 8 9 10 Signal VCC RESET COP RX1 TX1 INT0 INT1 P3.4 CUST GND Description 5V power reset to the micro coprocessor 1-Wire data Serial port 1 receive TTL Serial port 1 transmit TTL Interrupt 0 on DS89C420 Interrupt 1 on DS89C420 Port 3 bit 4 input/output customer 1-Wire data signal ground RJ-11 1-Wire Interface See Figure 8 below for the "Customer" 1-Wire Interface. This is the 1-Wire interface designed to be external to the board and accessible by the user or "customer". It provides a place for a DS1402-DR8 Blue Dot to be plugged in thus allowing customers easy access to make contact with their user tokens for debiting purposes. Figure 8. RJ-11 "Customer" 1-Wire Interface 1 2 3 4 5 6 Looking into Female RJ11 Connector Table 3. RJ-11 "Customer" 1-Wire Interface Pin Out Pin Signal name Description 1 2 3 4 5 6 VDD GND OW OW_GND no-connect no-connect +5 VDC output Power ground 1-Wire Data 1-Wire ground return 10 of 21 DSECASH: eCash Evaluation Kit DB9 Serial Interface See Figure 9 and Table 4 below for the DB9 Serial Interface pin out. A standard, straight-through serial cable (included in this kit) can be used to connect the evaluation board to a PC serial port. The above-mentioned eCashMonitor program then can be used to communicate with the board. See Appendix A: Advanced. This is the 1-Wire interface designed to be external to the board and accessible by the user or "customer". It provides a place for a DS1402-DR8 Blue Dot to be plugged in thus allowing customers easy access to make contact with their user tokens for debiting purposes. Figure 9. DB9 Serial Interface 1 6 2 7 3 8 4 9 5 Table 4. DB9 Serial Interface Pin Out Pin Signal name Description 1 2 3 4 5 6 7 8 9 no-connect RX12 TX12 DTR GND no-connect no-connect no-connect no-connect RS232 Receive RS232 Transmit Data Terminal Ready Ground Figure 10. Firmware Load Enable Jumper 1 2 Table 5. Firmware Load Enable Jumper Pin Out State Description JUMPER ON JUMPER OFF Firmware loading is controlled by DTR on RS232 serial interface Firmware loading disabled (default) 11 of 21 DSECASH: eCash Evaluation Kit Power Connector Power supply requirements: AC/DC, 9-20 V, 200mA Recommendations: Stancor Model STA-300R (Newark Electronics Stock No. 84F2081, Allied Electronics Stock No. 928-9895) Figure 11. Power Connector 2 1 5.5 mm 2.1 mm DSECASH INFORMATION For more information about the DSECASH, including software downloads, please consult the kit's web page located on our website at http://www.ibutton.com/ibuttons/ecashkit.html. TECHNICAL SUPPORT RESOURCES Dallas Semiconductor MAXIM provides many technical support resources for developers. In addition to data sheets, we provide a large number of application notes and white papers, software development tools, and a webbased discussion forum where technical questions can be posted for follow-up. iButton Product Data Sheets: http://para.maxim-ic.com/iButton.htm 1-Wire Product Data Sheets: http://para.maxim-ic.com/1Wire.htm Application Notes and White Papers: http://www.maxim-ic.com/appnotes10.cfm/ac_pk/1 Software Development Tools and SDK's: http://db.maxim-ic.com/ibutton/example/ Post technical questions to our web-based discussion forum: http://discuss.dalsemi.com/ 12 of 21 DSECASH: eCash Evaluation Kit SCHEMATICS See below for some the board schematics. Schematics covered are: Processor LCD and Piezo, Coprocessor and 1-Wire Customer, Power Supply, and the RS232 Serial Interface. Figure 12. Processor LCD and Piezo J3 2 1 PIEZO SOUNDER J4 BUZ1 1 BUZ2 2 SEL1 3 SEL2 4 SEL3 5 PB1 6 P1.6 7 PB2 8 RESET RX0 TX0 DUT P3.3 TIMER 0 P3.5 LCDENABLE P3.7 C12 22pF C13 22pF P1 J5 1 2 3 4 5 6 7 8 U7 P1.0/T2 P1.1/T2EX P1.2/RXD1 P1.3/TXD1 P1.4/INT2 P1.5/INT3 P1.6/INT4 P1.7/INT5 RESET P3.0/RXD0 P3.1/TXD0 P3.2/INT0 P3.3/INT1 P3.4/T0 P3.5/T1 P3.6/WR P3.7/RD X1 (IN) X2 (OUT) GND GND GND DS420-44PIN VCC VCC P0.0 (AD0) P0.1 (AD1) P0.2 (AD2) P0.3 (AD3) P0.4 (AD4) P0.5 (AD5) P0.6 (AD6) P0.7 (AD7) EA / VP ALE / PROG PSEN P2.0 (AD8) P2.1 (AD9) P2.2 (AD10) P2.3 (AD11) P2.4 (AD12) P2.5 (AD13) P2.6 (AD14) P2.7 (AD15) GND R4 10k 40 41 42 43 44 1 2 3 4 5 7 8 9 10 11 12 13 15 14 16 17 28 38 6 36 35 34 33 32 31 30 DUT SCL SDA P0.3 P0.4 P0.5 P0.6 P0.7 R6 2K VCC J6 1 2 3 4 5 6 7 8 P0 J7 LCD1 1 2 3 4 P3.7 5 LCDENABLE 6 7 8 9 10 11 12 13 14 15 16 VSS VDD CONTRAST DATA/CMD READ/WRITE ENABLE DB0 DB1 DB2 LCD DB3 DB4 DB5 DB6 DB7 BACKLIGHT + BACKLIGHT LCD AZ 29 EA 27 26 PSEN 18 19 20 21 22 23 24 25 39 P2.0 P2.1 P2.2 P2.3 P2.4 P2.5 P2.6 P2.7 X2 P3 X1 X1 22.118 MHz 1 2 3 4 5 6 7 8 P2 13 of 21 DSECASH: eCash Evaluation Kit Figure 13. Co-Processor And 1-Wire Customer VCC R8 1K 2 COPI R9 1K R12 3 10 Q2 2N7002 C14 100pF C15 100pF D COPO 1 G S 2 R14 22 1 2 CO-PROCESSOR TP COP D5 BAT54S 1 P1 3 1 2 CO-PROCESSOR P2 COP VCC TP5 R10 1K 2 CUSTI R11 1K R13 3 10 Q3 2N7002 C16 100pF C17 100pF D CUSTO 1 G S 2 R15 22 D6 BAT54S 1 TP 3 CUST RJ1 1 2 3 4 5 6 1-WIRE CUST 14 of 21 DSECASH: eCash Evaluation Kit Figure 14. Power Supply D1 1N4002 J1 1 2 POWER1 D2 1N4002 D4 1N4002 + C1 100uF D3 1N4002 1 U1 7805 GND VIN VOUT 3 + C2 22uF + C3 22uF C4 .1uF C5 .1uF TP2 GND TP3 VCC TP TP VCC VCC 2 TP1 GND Figure 15. RS232 Serial Interface VCC 14 2 7 1 3 PSEN 2 DTR5 1 VCC GND U2A 74HC125 R1 10K JP PROGRAM VCC C10 .1uF 7 5 18 4 19 12 15 16 11 9 6 RX12 TX12 DTR12 J2 TP VCC EA VCC 14 9 7 14 12 7 10 U3 TX0 13 2 14 5 7 VCC 6 RESET 8 VCC GND GND U2B 74HC125 VCC 11 P3.7 U2C 74HC125 GND U2D 74HC125 RX0 3 DTR5 20 13 14 10 17 8 1 VCC T1IN T1OUT T2IN T2OUT R1OUT R1IN R2OUT R2IN C1+ C2+ C1C2B+ VC2VBC2BV+ GND GND MAX203 1 6 2 7 3 8 4 9 5 DB9 Female 4 15 of 21 DSECASH: eCash Evaluation Kit APPENDIX A: THE ECASH PROCESSOR One of the purposes of the eCash processor is to offload the difficult 1-Wire SHA operations to a dedicated microprocessor. The eCash processor on the eCash evaluation board utilizes the DS1963S in an internal 1-Wire network to perform the SHA-1 authentication and signing of service data. This has speed advantages and also securely keeps the secrets in a stainless steel iButton package. Alternately, the firmware written in `C' can be ported to many different processors. There are three main operating modes to the eCash processor: Autonomous, Lock-Step, and Manual. Autonomous mode allows the eCash processor to work without any interaction with the host processor. However, status information will be sent out the serial interface when an event occurs. Lock-Step mode allows the eCash processor to do all of the 1-Wire authentication and/or debiting work but allows the host to approve key steps in the process. Manual mode allows the host to instruct the eCash processor to do any individual operation. The Manual mode commands can also be used while the eCash processor is in Autonomous or Lock-Step mode. Figure 16. eCash Processor Application Example Service Control Unit eCash Evaluation Board Optional IO Serial Interface iButton Reader Host System (microprocessor) eCash processor External 1-Wire Internal 1-Wire Coprocessor for DS1963S Coprocessor for DS1961S Speed considerations: Autonomous is the fastest, Lock-Step is next and full Manual mode is the slowest due to the overhead constraint of serial communication before each 1-Wire operation. Table 6. Mode Flags Sequence (and bit #) 0 1 2 3 4 5 6 7 Operation Description Automatic 1-Wire polling for user token Automatic read and authentication Automatic debit Automatic Pulse of I/O bit Automatic update of the LCD Enable Overdrive operation not used not used 16 of 21 DSECASH: eCash Evaluation Kit These autonomous operations are enable or disabled with the manual set command. The inbound command format has two different types: `get' or `set'. The get format provides a single character designator. The set parameter provides a single character designator and also a data field preceded with a length character. Table 7. Inbound Format Format GX SX Description Get command where X is a one character designator Set command where X is a one-character designator and Example: GF Get the F parameter data Example: SQ3ABC Sets the Q parameter with a three character data field of ABC. There are two types of outbound messages. The first type is as a result of a get command and provides the one byte designator and data length followed by the data. The second message type is an asynchronous event. The event also has a type designator, length and data. Table 8. Outbound Format Format RXhh Example: EQ04ABCD Event type Q occurred and four characters of data are provided `ABCD'. Example: RQ01Z Response type Q occurred and one character of data is provided `Z'. Table 9 lists all of the `get' and `set' commands. 17 of 21 DSECASH: eCash Evaluation Kit Table 9. Get Commands Command + Format GD GL GP GS GU Description Get time of last debit Get the last message sent (response or event). Read pages(specified by SP) of Coprocessor specified with SN and return Get status (dump of Memory State Table 6) Read pages(specified by SU) of user token Get firmware version Get ROM of coprocessor, if more then one coprocessor, use SN command to select GV GW Table 10. Set Commands Command + Description Format SAzy SBz SCy SFaaaa SGhhaaa... SIppx SKz SLxy SMhhhh SNx SPhh SR SShh STxb SUhh SYhh Enables (y=1) or disables (y=0) mode flag (z=0 for AutoPolling, 1 for AutoReading, 2 for AutoDebiting, 3 for Pulsing IO bit, 4 for Update LCD, 5 for Use Overdrive Speed) Abort the Lock-Step event (z=0 for Arrival, z=1 for read, z=2 for Debit) Enable/Disable (y 1 enable, 0 disable) CRC16 of all packets sent from the eCash processor to the host. The inverted CRC16 is calculated over the entire packet and appended as a 4 character hex value. Set service filename aaa (ASCII file name, extension always 102 dec) Set the LCD to the text message (aaa...) of length hh (hex, max 16). If length N is 0 then clear display. Set the port pin `pp' to the value `x'. Acknowledge the Lock-Step event X so the next autonomous operation can be done (0 - poll, 1 - read, 2 - debit) Enable/Disable (y=1 enable, y=0 disable) a Lock-Step state. (x=0 for Arrival, 1 for Read, 2 for Debit). Will reset current Lock-Step status Set debit amount (hhhh hex number in hundredth of a unit) Set the coprocessor number to read pages from (x=0 for DS1963S coprocessor or x=1 for DS1961S coprocessor) Set the coprocessor page to read with the GP command (hh hex page number) Soft Reset of eCash processor, will get a reset event when complete Play beep (Sound) with (hh hex number of beeps) Toggle port x bit b, where x and b are 4-bit ascii-encoded hex nibbles. Set the user token page to read (hh page hex number) Set the debit timeout value in hh seconds 18 of 21 DSECASH: eCash Evaluation Kit Note that the Status State below does not contain all of the state information. State information that can be read directly was omitted (e.g. GV for get version). Table 11. Status State Designator A C D Length (hex) 02 01 02 04 10 02 06 01 02 02 02 10 02 02 Example Data (hex) 01 1 64 ABCD eCash Demo V0.8 0102 020000 0 01 32 08 1800000000001122 10 01 Description Autonomous operation mode flags (1 ASCII encoded hex byte) (See Table 1) CRC16 enable flag (1 enabled, 0 disabled) Time of last debit in milliseconds ASCII Service filename Current LCD text message Lock-step acknowledge flags (see Table 7) Amount to debit composed of 3 ASCII-encoded hex bytes, representing amount to debit (LSB first) Coprocessor number selected (0=DS1963S or 1=DS1961S) Page number to read from the current coprocessor Port and bit number for the I/O pulse (1 ASCII encoded hex byte) Page number to read from user Token Coprocessor ROM ID Debit timeout in seconds Status flags (see Table 8) F G L M N P T U W Y Z Table 12. Acknowledge Flags Flag (bit position) 0 1 2 3 4 5 6 7 Description Ack_PollEnabled Ack_PollWaiting Ack_ReadEnabled Ack_ReadWaiting Ack_DebitEnabled Ack_DebitWaiting Don't Care Don't Care Table 13. Status Flags Flag (bit position) 0 1 2 3 4 5 6 7 Description Stat_Poll Stat_Read Stat_DebitCert Stat_UpdateToken Stat_Verify Stat_WaitUntilGone Don't Care Don't Care 19 of 21 DSECASH: eCash Evaluation Kit Table 14. Events Code Operation Description R A L U S M D I C E Soft reset complete 1-Wire arrival reporting, data is ROM 1-Wire departure reporting, data is ROM Automatic read of select pages from user Authenticated raw service data (8 bytes) Authenticated monetary balance service data Debited final balance IO bit pulse after completion of D. (If D is not set then pulse on completion of S or M). Status displayed on LCD, length variable Error (see Table 10) Length + Data Payload Format 00 10RRRRRRRRRRRRRRRR 10RRRRRRRRRRRRRRRR 40AA55AA55AA55AA55AA55AA55AA5 5AA55AA55AA55AA55AA55AA55AA55 AA55AA55 10CTCMCMMBMBMBIDID 06MBMBMB 06MBMBMB 00 0155 010A Table 15. Error Codes Code (hex) 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 10 Description No valid token found during poll Tear occurred, the device contents have not changed Tear occurred, the device contents are in an unknown state Tear occurred, but a fix has been applied. Retry verification. Failed to erase coprocessor scratchpad. Failed to find account file Failed to get challenge from coprocessor During Read: Failed to issue challenge to token During Verify: Failed to issue challenge to token Failed to read token's account data, or data is bad Failed to compute the UTS Device failed authentication Money file signature failed validation Failed to update the device Insufficient funds for debit. Failed to erase scratchpad. 20 of 21 DSECASH: eCash Evaluation Kit Example Responses: GU: RU200FAA008039070000444C534D660A0100BEED520001040094CE0000000000E3F GP: RP200FAA008063750000434F5052180104004AE1520001040094CEAAAAAAAAAAAAAA GS: (CR's and spaces added for clarity) RS63 A02 37 C01 0 D02 00 F04 DLSM G0F iButton eCash L02 00 M06 01000 N01 0 P02 00 T02 00 U02 00 W10 18F6AA0200000043 Y02 10 Z02 01 GD: RD0268 21 of 21 |
Price & Availability of DSECASH
 |
|
|
|
|
All Rights Reserved © IC-ON-LINE 2003 - 2022 |
| [Add Bookmark] [Contact Us] [Link exchange] [Privacy policy] |
|
Mirror Sites : [www.datasheet.hk]
[www.maxim4u.com] [www.ic-on-line.cn]
[www.ic-on-line.com] [www.ic-on-line.net]
[www.alldatasheet.com.cn]
[www.gdcy.com]
[www.gdcy.net] |